home *** CD-ROM | disk | FTP | other *** search
/ Personal Computer World 2009 February / PCWFEB09.iso / Software / Linux / Kubuntu 8.10 / kubuntu-8.10-desktop-i386.iso / casper / filesystem.squashfs / usr / lib / python2.5 / socket.pyc (.txt) < prev    next >
Python Compiled Bytecode  |  2008-10-29  |  13KB  |  468 lines

  1. # Source Generated with Decompyle++
  2. # File: in.pyc (Python 2.5)
  3.  
  4. """This module provides socket operations and some related functions.
  5. On Unix, it supports IP (Internet Protocol) and Unix domain sockets.
  6. On other systems, it only supports IP. Functions specific for a
  7. socket are available as methods of the socket object.
  8.  
  9. Functions:
  10.  
  11. socket() -- create a new socket object
  12. socketpair() -- create a pair of new socket objects [*]
  13. fromfd() -- create a socket object from an open file descriptor [*]
  14. gethostname() -- return the current hostname
  15. gethostbyname() -- map a hostname to its IP number
  16. gethostbyaddr() -- map an IP number or hostname to DNS info
  17. getservbyname() -- map a service name and a protocol name to a port number
  18. getprotobyname() -- mape a protocol name (e.g. 'tcp') to a number
  19. ntohs(), ntohl() -- convert 16, 32 bit int from network to host byte order
  20. htons(), htonl() -- convert 16, 32 bit int from host to network byte order
  21. inet_aton() -- convert IP addr string (123.45.67.89) to 32-bit packed format
  22. inet_ntoa() -- convert 32-bit packed format IP to string (123.45.67.89)
  23. ssl() -- secure socket layer support (only available if configured)
  24. socket.getdefaulttimeout() -- get the default timeout value
  25. socket.setdefaulttimeout() -- set the default timeout value
  26.  
  27.  [*] not available on all platforms!
  28.  
  29. Special objects:
  30.  
  31. SocketType -- type object for socket objects
  32. error -- exception raised for I/O errors
  33. has_ipv6 -- boolean value indicating if IPv6 is supported
  34.  
  35. Integer constants:
  36.  
  37. AF_INET, AF_UNIX -- socket domains (first argument to socket() call)
  38. SOCK_STREAM, SOCK_DGRAM, SOCK_RAW -- socket types (second argument)
  39.  
  40. Many other constants may be defined; these may be used in calls to
  41. the setsockopt() and getsockopt() methods.
  42. """
  43. import _socket
  44. from _socket import *
  45. _have_ssl = False
  46.  
  47. try:
  48.     import _ssl
  49.     from _ssl import *
  50.     _have_ssl = True
  51. except ImportError:
  52.     pass
  53.  
  54. import os
  55. import sys
  56.  
  57. try:
  58.     from cStringIO import StringIO
  59. except ImportError:
  60.     from StringIO import StringIO
  61.  
  62.  
  63. try:
  64.     from errno import EBADF
  65. except ImportError:
  66.     EBADF = 9
  67.  
  68. __all__ = [
  69.     'getfqdn']
  70. __all__.extend(os._get_exports_list(_socket))
  71. if _have_ssl:
  72.     __all__.extend(os._get_exports_list(_ssl))
  73.  
  74. _realsocket = socket
  75. if _have_ssl:
  76.     _realssl = ssl
  77.     
  78.     def ssl(sock, keyfile = None, certfile = None):
  79.         if hasattr(sock, '_sock'):
  80.             sock = sock._sock
  81.         
  82.         return _realssl(sock, keyfile, certfile)
  83.  
  84.  
  85. if sys.platform.lower().startswith('win'):
  86.     errorTab = { }
  87.     errorTab[10004] = 'The operation was interrupted.'
  88.     errorTab[10009] = 'A bad file handle was passed.'
  89.     errorTab[10013] = 'Permission denied.'
  90.     errorTab[10014] = 'A fault occurred on the network??'
  91.     errorTab[10022] = 'An invalid operation was attempted.'
  92.     errorTab[10035] = 'The socket operation would block'
  93.     errorTab[10036] = 'A blocking operation is already in progress.'
  94.     errorTab[10048] = 'The network address is in use.'
  95.     errorTab[10054] = 'The connection has been reset.'
  96.     errorTab[10058] = 'The network has been shut down.'
  97.     errorTab[10060] = 'The operation timed out.'
  98.     errorTab[10061] = 'Connection refused.'
  99.     errorTab[10063] = 'The name is too long.'
  100.     errorTab[10064] = 'The host is down.'
  101.     errorTab[10065] = 'The host is unreachable.'
  102.     __all__.append('errorTab')
  103.  
  104.  
  105. def getfqdn(name = ''):
  106.     '''Get fully qualified domain name from name.
  107.  
  108.     An empty argument is interpreted as meaning the local host.
  109.  
  110.     First the hostname returned by gethostbyaddr() is checked, then
  111.     possibly existing aliases. In case no FQDN is available, hostname
  112.     from gethostname() is returned.
  113.     '''
  114.     name = name.strip()
  115.     if not name or name == '0.0.0.0':
  116.         name = gethostname()
  117.     
  118.     
  119.     try:
  120.         (hostname, aliases, ipaddrs) = gethostbyaddr(name)
  121.     except error:
  122.         pass
  123.  
  124.     aliases.insert(0, hostname)
  125.     for name in aliases:
  126.         if '.' in name:
  127.             break
  128.             continue
  129.     else:
  130.         name = hostname
  131.     return name
  132.  
  133. _socketmethods = ('bind', 'connect', 'connect_ex', 'fileno', 'listen', 'getpeername', 'getsockname', 'getsockopt', 'setsockopt', 'sendall', 'setblocking', 'settimeout', 'gettimeout', 'shutdown')
  134. if sys.platform == 'riscos':
  135.     _socketmethods = _socketmethods + ('sleeptaskw',)
  136.  
  137. _delegate_methods = ('recv', 'recvfrom', 'recv_into', 'recvfrom_into', 'send', 'sendto')
  138.  
  139. class _closedsocket(object):
  140.     __slots__ = []
  141.     
  142.     def _dummy(*args):
  143.         raise error(EBADF, 'Bad file descriptor')
  144.  
  145.     send = recv = recv_into = sendto = recvfrom = recvfrom_into = _dummy
  146.     __getattr__ = _dummy
  147.  
  148.  
  149. class _socketobject(object):
  150.     __doc__ = _realsocket.__doc__
  151.     __slots__ = [
  152.         '_sock',
  153.         '__weakref__'] + list(_delegate_methods)
  154.     
  155.     def __init__(self, family = AF_INET, type = SOCK_STREAM, proto = 0, _sock = None):
  156.         if _sock is None:
  157.             _sock = _realsocket(family, type, proto)
  158.         
  159.         self._sock = _sock
  160.         for method in _delegate_methods:
  161.             setattr(self, method, getattr(_sock, method))
  162.         
  163.  
  164.     
  165.     def close(self):
  166.         self._sock = _closedsocket()
  167.         dummy = self._sock._dummy
  168.         for method in _delegate_methods:
  169.             setattr(self, method, dummy)
  170.         
  171.  
  172.     close.__doc__ = _realsocket.close.__doc__
  173.     
  174.     def accept(self):
  175.         (sock, addr) = self._sock.accept()
  176.         return (_socketobject(_sock = sock), addr)
  177.  
  178.     accept.__doc__ = _realsocket.accept.__doc__
  179.     
  180.     def dup(self):
  181.         '''dup() -> socket object
  182.  
  183.         Return a new socket object connected to the same system resource.'''
  184.         return _socketobject(_sock = self._sock)
  185.  
  186.     
  187.     def makefile(self, mode = 'r', bufsize = -1):
  188.         '''makefile([mode[, bufsize]]) -> file object
  189.  
  190.         Return a regular file object corresponding to the socket.  The mode
  191.         and bufsize arguments are as for the built-in open() function.'''
  192.         return _fileobject(self._sock, mode, bufsize)
  193.  
  194.     family = property((lambda self: self._sock.family), doc = 'the socket family')
  195.     type = property((lambda self: self._sock.type), doc = 'the socket type')
  196.     proto = property((lambda self: self._sock.proto), doc = 'the socket protocol')
  197.     _s = 'def %s(self, *args): return self._sock.%s(*args)\n\n%s.__doc__ = _realsocket.%s.__doc__\n'
  198.     for _m in _socketmethods:
  199.         exec _s % (_m, _m, _m, _m)
  200.     
  201.     del _m
  202.     del _s
  203.  
  204. socket = SocketType = _socketobject
  205.  
  206. class _fileobject(object):
  207.     '''Faux file object attached to a socket object.'''
  208.     default_bufsize = 8192
  209.     name = '<socket>'
  210.     __slots__ = [
  211.         'mode',
  212.         'bufsize',
  213.         'softspace',
  214.         '_sock',
  215.         '_rbufsize',
  216.         '_wbufsize',
  217.         '_rbuf',
  218.         '_wbuf',
  219.         '_close']
  220.     
  221.     def __init__(self, sock, mode = 'rb', bufsize = -1, close = False):
  222.         self._sock = sock
  223.         self.mode = mode
  224.         if bufsize < 0:
  225.             bufsize = self.default_bufsize
  226.         
  227.         self.bufsize = bufsize
  228.         self.softspace = False
  229.         if bufsize == 0:
  230.             self._rbufsize = 1
  231.         elif bufsize == 1:
  232.             self._rbufsize = self.default_bufsize
  233.         else:
  234.             self._rbufsize = bufsize
  235.         self._wbufsize = bufsize
  236.         self._rbuf = StringIO()
  237.         self._wbuf = []
  238.         self._close = close
  239.  
  240.     
  241.     def _getclosed(self):
  242.         return self._sock is None
  243.  
  244.     closed = property(_getclosed, doc = 'True if the file is closed')
  245.     
  246.     def close(self):
  247.         
  248.         try:
  249.             if self._sock:
  250.                 self.flush()
  251.         finally:
  252.             if self._close:
  253.                 self._sock.close()
  254.             
  255.             self._sock = None
  256.  
  257.  
  258.     
  259.     def __del__(self):
  260.         
  261.         try:
  262.             self.close()
  263.         except:
  264.             pass
  265.  
  266.  
  267.     
  268.     def flush(self):
  269.         if self._wbuf:
  270.             buffer = ''.join(self._wbuf)
  271.             self._wbuf = []
  272.             self._sock.sendall(buffer)
  273.         
  274.  
  275.     
  276.     def fileno(self):
  277.         return self._sock.fileno()
  278.  
  279.     
  280.     def write(self, data):
  281.         data = str(data)
  282.         if not data:
  283.             return None
  284.         
  285.         self._wbuf.append(data)
  286.         if not self._wbufsize == 0:
  287.             if self._wbufsize == 1 or '\n' in data or self._get_wbuf_len() >= self._wbufsize:
  288.                 self.flush()
  289.             
  290.  
  291.     
  292.     def writelines(self, list):
  293.         self._wbuf.extend(filter(None, map(str, list)))
  294.         if self._wbufsize <= 1 or self._get_wbuf_len() >= self._wbufsize:
  295.             self.flush()
  296.         
  297.  
  298.     
  299.     def _get_wbuf_len(self):
  300.         buf_len = 0
  301.         for x in self._wbuf:
  302.             buf_len += len(x)
  303.         
  304.         return buf_len
  305.  
  306.     
  307.     def read(self, size = -1):
  308.         rbufsize = max(self._rbufsize, self.default_bufsize)
  309.         buf = self._rbuf
  310.         buf.seek(0, 2)
  311.         if size < 0:
  312.             self._rbuf = StringIO()
  313.             while True:
  314.                 data = self._sock.recv(rbufsize)
  315.                 if not data:
  316.                     break
  317.                 
  318.                 buf.write(data)
  319.             return buf.getvalue()
  320.         else:
  321.             buf_len = buf.tell()
  322.             if buf_len >= size:
  323.                 buf.seek(0)
  324.                 rv = buf.read(size)
  325.                 self._rbuf = StringIO()
  326.                 self._rbuf.write(buf.read())
  327.                 return rv
  328.             
  329.             self._rbuf = StringIO()
  330.             while True:
  331.                 left = size - buf_len
  332.                 data = self._sock.recv(left)
  333.                 if not data:
  334.                     break
  335.                 
  336.                 n = len(data)
  337.                 if n == size and not buf_len:
  338.                     return data
  339.                 
  340.                 if n == left:
  341.                     buf.write(data)
  342.                     del data
  343.                     break
  344.                 
  345.                 if not n <= left:
  346.                     raise AssertionError, 'recv(%d) returned %d bytes' % (left, n)
  347.                 buf.write(data)
  348.                 buf_len += n
  349.                 del data
  350.             return buf.getvalue()
  351.  
  352.     
  353.     def readline(self, size = -1):
  354.         buf = self._rbuf
  355.         buf.seek(0, 2)
  356.         if buf.tell() > 0:
  357.             buf.seek(0)
  358.             bline = buf.readline(size)
  359.             if bline.endswith('\n') or len(bline) == size:
  360.                 self._rbuf = StringIO()
  361.                 self._rbuf.write(buf.read())
  362.                 return bline
  363.             
  364.             del bline
  365.         
  366.         if size < 0:
  367.             if self._rbufsize <= 1:
  368.                 buf.seek(0)
  369.                 buffers = [
  370.                     buf.read()]
  371.                 self._rbuf = StringIO()
  372.                 data = None
  373.                 recv = self._sock.recv
  374.                 while data != '\n':
  375.                     data = recv(1)
  376.                     if not data:
  377.                         break
  378.                     
  379.                     buffers.append(data)
  380.                 return ''.join(buffers)
  381.             
  382.             buf.seek(0, 2)
  383.             self._rbuf = StringIO()
  384.             while True:
  385.                 data = self._sock.recv(self._rbufsize)
  386.                 if not data:
  387.                     break
  388.                 
  389.                 nl = data.find('\n')
  390.                 if nl >= 0:
  391.                     nl += 1
  392.                     buf.write(buffer(data, 0, nl))
  393.                     self._rbuf.write(buffer(data, nl))
  394.                     del data
  395.                     break
  396.                 
  397.                 buf.write(data)
  398.             return buf.getvalue()
  399.         else:
  400.             buf.seek(0, 2)
  401.             buf_len = buf.tell()
  402.             if buf_len >= size:
  403.                 buf.seek(0)
  404.                 rv = buf.read(size)
  405.                 self._rbuf = StringIO()
  406.                 self._rbuf.write(buf.read())
  407.                 return rv
  408.             
  409.             self._rbuf = StringIO()
  410.             while True:
  411.                 data = self._sock.recv(self._rbufsize)
  412.                 if not data:
  413.                     break
  414.                 
  415.                 left = size - buf_len
  416.                 nl = data.find('\n', 0, left)
  417.                 if nl >= 0:
  418.                     nl += 1
  419.                     self._rbuf.write(buffer(data, nl))
  420.                     if buf_len:
  421.                         buf.write(buffer(data, 0, nl))
  422.                         break
  423.                     else:
  424.                         return data[:nl]
  425.                 
  426.                 n = len(data)
  427.                 if n == size and not buf_len:
  428.                     return data
  429.                 
  430.                 if n >= left:
  431.                     buf.write(buffer(data, 0, left))
  432.                     self._rbuf.write(buffer(data, left))
  433.                     break
  434.                 
  435.                 buf.write(data)
  436.                 buf_len += n
  437.             return buf.getvalue()
  438.  
  439.     
  440.     def readlines(self, sizehint = 0):
  441.         total = 0
  442.         list = []
  443.         while True:
  444.             line = self.readline()
  445.             if not line:
  446.                 break
  447.             
  448.             list.append(line)
  449.             total += len(line)
  450.             if sizehint and total >= sizehint:
  451.                 break
  452.                 continue
  453.         return list
  454.  
  455.     
  456.     def __iter__(self):
  457.         return self
  458.  
  459.     
  460.     def next(self):
  461.         line = self.readline()
  462.         if not line:
  463.             raise StopIteration
  464.         
  465.         return line
  466.  
  467.  
  468.